home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / sysact11.arc / SYSACT.DOC < prev    next >
Text File  |  1987-02-01  |  6KB  |  177 lines
  1.  
  2. SYSACT                     PCDOS/MSDOS                    SYSACT   
  3.  
  4.  
  5. NAME
  6.      SYSACT, ACTRPT, SAFMT
  7.  
  8. DESCRIPTION
  9.      This Unix-like facility is provided to help advanced PC users
  10.      analyze system activity and to identify programs that are 
  11.      consuming the majority of system resources.
  12.  
  13.      System activity logging is performed by the SYSACT resident program.
  14.      Upon termination of a process, one record is written to the file 
  15.      C:\SYSACT.LOG.  The SARPT batch can summarize this data. 
  16.  
  17. FILES
  18.      C:\SYSACT.LOG     system activity logging file
  19.      SYSACT.COM        system activity logger
  20.      ACTRPT.BAT        report generator batch
  21.      SAFMT.COM         report formatter, generally called by ACTRPT
  22.      SYSACT.H          activity log file format definition
  23.      ASKYN.COM         utility used by ACTRPT batch to ask questions
  24.  
  25. DISTRIBUTION
  26.      This system activity facility is provided free of charge for 
  27.      personal use only.  You may copy and distribute this package 
  28.      for any non-commercial purpose.  Please contact the author for 
  29.      licensing for other applications.
  30.  
  31.      This document and the associated programs are copyright material
  32.      and should not be modified or sold.
  33.  
  34.      Copyright (C) 1987 Samuel H. Smith,
  35.      All commercial rights reserved.
  36.  
  37.      Address all inquiries to:
  38.         S.H.Smith
  39.         5119 N. 11th Ave 332
  40.         Phoenix, Az 85013
  41.  
  42.  
  43.  
  44. SYSACT(2)                  PCDOS/MSDOS                    SYSACT(2)
  45.  
  46.  
  47. NAME
  48.      SYSACT - System activity logger
  49.  
  50. SYNOPSIS
  51.      SYSACT.COM  (called from AUTOEXEC.BAT)
  52.  
  53. FILES
  54.      C:\SYSACT.LOG   system activity log file
  55.      SYSACT.H        log file format definition
  56.  
  57. DESCRIPTION
  58.      SYSACT becomes resident and creates a system activity file, in the
  59.      form described in SYSACT.H.  This file is interpreted and
  60.      reported on by SAFMT.COM and ACTRPT.BAT.
  61.  
  62.      SYSACT should be called once during system startup.  This should
  63.      normally be done in the AUTOEXEC.BAT file.   The activity logger 
  64.      becomes resident and will remain active until the system is 
  65.      rebooted.  
  66.  
  67.      In multi-process environments, such as DoubleDOS, the activity 
  68.      logger must be started separately in each partition.  Each 
  69.      instance of SA consumes only about 1k of RAM. 
  70.  
  71.      Here is a sample of the contents of the SYSACT.LOG file:
  72.          sort.exe     02-01-87 13:28:34 00:00:01.27 0002 0001 0005
  73.          turbo.com    02-01-87 13:28:58 00:00:44.21 0003 0000 0010
  74.          list.com     02-01-87 13:29:52 00:00:39.99 0006 0000 001B
  75.          q.com        02-01-87 13:31:39 00:01:38.92 0001 0001 0016
  76.          sort.exe     02-01-87 13:31:56 00:00:10.50 0002 0001 0005
  77.          ed.exe       02-01-87 13:43:43 00:08:10.27 0004 0001 0035
  78.  
  79.  
  80. NOTES
  81.      The DOS call counters are stored in 16 bits and will overflow to 
  82.      zero without warning. 
  83.  
  84.      SYSACT only reports on processes that have terminated.
  85.  
  86.  
  87.  
  88. ACTRPT                     PCDOS/MSDOS                    ACTRPT   
  89.  
  90.  
  91. NAME
  92.      ACTRPT - Activity report generator batch
  93.  
  94. SYNOPSIS
  95.      actrpt
  96.  
  97. DESCRIPTION
  98.      ACTRPT provides a simplified interface to the facilities of SAFMT.
  99.      It asks a series of questions and then processes the activity log
  100.      based on the operator's responses.
  101.  
  102.  
  103. DIALOGUE
  104.      Do you want a standard system activity report? (y/n)
  105.  
  106.      Do you want a system activity report that includes lines for
  107.      commands executed only once? (y/n)
  108.  
  109.      Do you want a system activity report without the I/O counts? (y/n)
  110.  
  111.      Output report to the screen? (y/n)
  112.  
  113.      Output report to the printer? (y/n)
  114.  
  115.      Do you want to replace the activity log with a summary
  116.      of it's current contents? (y/n)
  117.  
  118.  
  119. SAMPLE OUTPUT
  120.      Here is an example of a report generated by ACTRPT:
  121.  
  122.            Total    Average  -- Sys Call Averages --   
  123.            Time      Time     Reads  Writes   Misc    Runs     Command
  124.         ---------- --------- ------- ------- ------- ------ --------------
  125.            5070.4    316.90       2       3      24     16   turbo.com   
  126.            3068.5    191.78       3    2639    2757     16   **others
  127.            1747.0     75.96       3       0      19     23   list.com    
  128.             335.2     23.94       2       1    2222     14   more.com    
  129.             178.3     25.48       9       4    6852      7   vi.exe      
  130.             177.8     29.63       1     655      46      6   masm.exe    
  131.             108.1      4.32       3      22       6     25   sarpt.com   
  132.               3.6      1.19       0       0      12      3   sortall.com 
  133.               1.3      0.63       2       1       4      2   unique.com  
  134.               0.8      0.41       0       0       3      2   mode.com    
  135.  
  136.  
  137.  
  138.  
  139. SAFMT                      PCDOS/MSDOS                    SAFMT   
  140.  
  141.  
  142. NAME
  143.      SAFMT - Format command summary from system activity log records 
  144.              (usually called from ACTRPT.BAT)
  145.  
  146. SYNOPSIS
  147.      sort <c:\sysact.log | SAFMT [-i] [-j] [-v] [-s] >sumfile
  148.      actrpt
  149.  
  150. DESCRIPTION
  151.      SAFMT reads a sorted system activity file, in the form described in 
  152.      SYSACT.H.  It adds all records that executed identically-named
  153.      commands and writes them to the standard output.  
  154.      
  155.      The options are:
  156.  
  157.      -j  Combine all commands invoked only once under ``**others''.
  158.  
  159.      -i  Exclude columns containing the I/O counts from the output.
  160.  
  161.      -v  Exclude column headings from the output.
  162.  
  163.      -s  Produce a summary file that can replace SYSACT.LOG.
  164.  
  165.  
  166.      A typical sequence for activity reporting is:
  167.           sort <c:\sysact.log | sarpt -j >report1
  168.           sort <report1 >report1
  169.           print report1 report2
  170.  
  171.  
  172.      A typical sequence for activity log maintenance is:
  173.           copy c:\sysact.log sysact.old
  174.           sort <c:\sysact.log | sarpt -s >c:\sysact.log
  175.  
  176.  
  177.